Release 10.1A: OpenEdge Application Server:
Administration

Editing BrokerConnect attributes in ubroker.properties

The Adapter root group in the ubroker.properties file supports the instance of the SonicMQ Broker for BrokerConnect. You can configure BrokerConnect by manually editing this file.

Guidelines for editing the properties file

When editing the ubroker.properties file without the Progress Explorer, note that:

You should not directly change the values in the ubroker.properties file unless you have a complete understanding of how the changes affect components. When possible, always use the Progress Explorer to make all changes to this file.
Note: You can use the mergeprop utility installed with OpenEdge to manually edit the ubroker.properties file. For information on using mergeprop, see OpenEdge Getting Started: Installation and Configuration .
Always make a copy of this file, edit the copy, and verify the result before replacing the original with your edited copy.
For complete definitions of all the properties and detailed information on how to set them, see the ubroker.properties.README file, as well as the comments included in the properties file itself. Both files reside in the properties directory.

The file consists of a hierarchical structure of configuration entities, where parent entities provide configuration information that you can override or extend in each child entity. Each configuration entity has a name that begins the entity definition, and the definition contains configuration settings for one or more products or product instances.

AppServer entries in the properties file

BrokerConnect configurations in ubroker.properties can include the entities listed in Table 15–1.

Table 15–1: AppServer configuration entity names 

Configuration entity name	Configuration entity function
[Adapter]	Defines default property settings for all BrokerConnect instances.
[Adapter.product-instance-name]	Defines property settings for the BrokerConnect instance. The ubroker.properties file can contain several of these entities, each with a unique product-instance-name. For BrokerConnect, product-instance-name is the name you specify for the adapter instance.

Server startup parameters

You can optionally specify the attributes described in Table 15–2 in the srvrStartupParam property of BrokerConnect.

Table 15–2: BrokerConnect attributes 

Attribute	Value	Default
brokerURL	String	Null
user	String	Null
password	String	Null
clientID	String	Null
pingInterval	Number (of seconds) controlling how frequently the adapter instance pings the broker to verify that the broker is responding.	None; adapter instance does not ping broker unless an interval is specified.

If srvrStartupParam attributes are specified, they serve as default values for all of the clients; however, the 4GL-JMS API allows clients to overwrite the srvrStartupParam defaults.

Names of attributes are case-sensitive. The attributes must be separated with a semicolon (;). For example:

srvrStartupParam=brokerURL=localHost; user=u1; password=p1;